home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / pccark1.zip / PCCARK.DOC < prev    next >
Text File  |  1988-08-22  |  4KB  |  96 lines
  1.  
  2.                                   PCCARK V1.0
  3.                             An ARC-File Copy/Lister
  4.                                        by 
  5.                             Drue Kennon & Gary Smith
  6.  
  7.  
  8.         PCCARK was written because of a need to reduce the size of an
  9.         arc file viewer for use with PcConnect.  We added to this the
  10.         abiltiy to create a new arcfile and copy selected files from
  11.         within an arc file into this new file.  This ability is limited
  12.         to copying files from only one archive into the new archive. We
  13.         have not attempted to write another merge utility like Tom 
  14.         Henderson's MARC.
  15.  
  16.         Often it is desirable to create a listing of all the files
  17.         contained in your numerous arcfiles as a quick reference. PCCARK
  18.         provides that ability.
  19.  
  20.         Enough of what it will and won't do, here's how it works.
  21.  
  22.         PCCARK alone will cause the program to display a short help
  23.         screen on the usage features.  They are as follows.
  24.  
  25.         c:>pccark <source> <target> [<filename(s)> . . . . ]
  26.  
  27.         In Which: <source> is the ARChive we get our files from, and
  28.                   <target> is the ????????.arc file we move files to or
  29.                            the text file to receive arcfile listing.
  30.                   <filename(s)> is/are the file(s) we should copy.
  31.  
  32.         <filename(s)> can be in the form of a list file named << PCCARK.LST >>
  33.         which contains the names of the files found in <source> you wish copied
  34.         into <target>.  PCCARK.LST must be specified on the command line. 
  35.         No default check for this file is attempted.
  36.  
  37.         If no <filename(s)> is/are given, a listing of files contained
  38.         in <source> is assumed, and if <target> IS specified, it is assumed.
  39.         to be the file name to receive the arcfile listing.  Otherwise the
  40.         listing go to standard out (screen).
  41.  
  42.  
  43.         e.g.
  44.         c:>PCCARK  prints the above screen basically
  45.  
  46.         c:>PCCARK MYARC.ARC  produces a screen listing of the files in myarc.
  47.  
  48.         c:>PCCARK MYARC.ARC MYARC.LST  
  49.  
  50.            Produces a listing of myarc and the listing is written to myarc.lst 
  51.            on disk.  If the listfile exists it is appended with the new list.
  52.  
  53.         c:>PCCARK MYARC.ARC NEWARC.ARC PCCARK.LST
  54.  
  55.            The file pccark.lst is used to supply a list of files contained in
  56.            myarc.arc that we will copy into the created arcfile newarc.arc.
  57.            The pccark.lst file should look like this...
  58.  
  59.            <TOP OF FILE>
  60.            myfile1.c
  61.            myfile2.c
  62.            myfile3.c
  63.            ...........more files
  64.            myfiles.h
  65.            <END OF FILE>
  66.  
  67.         PCCARK.lst is the only list-file name allowed.
  68.  
  69.         c:>PCCARK MYARC.ARC NEWARC.ARC myfile1.c myfile3.c myfiles.h
  70.  
  71.            The files < myfile1.c myfile3.c myfiles.h > will be copied from
  72.            myarc.arc into the created newarc.arc file.
  73.  
  74.         It's just that simple.
  75.  
  76.         As always when I code for dealing with archive files, my thanks go
  77.         to Gary Conway and Infinity Design Concepts for his documentation
  78.         on NARC, and to Tom Henderson for his pioneering work in the ARChive
  79.         file field.
  80.  
  81.         PCCARK.exe will currently recognize and deal with the 9 known methods
  82.         of file storage. 1=Storing - Squishing - Crunching - 9=Squashing.
  83.  
  84.         Who knows, .... Storquishrunchquashing may be next in line.
  85.  
  86.                                                 Drue
  87.  
  88.         Send no money for PCCARK even if you do like it.  Just say a silent
  89.         thankx and call the board no and then.  Take part in the programming
  90.         discussions etc... and generally help someone else learn what you know.
  91.  
  92.         The Programmer's Source (409) 598-9057
  93.         The Programmer's Corner (301) 794-8106 node1  (301) 794-4331 node2
  94.  
  95.  
  96.